home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libelf / elf_getarhdr.z / elf_getarhdr
Encoding:
Text File  |  2002-10-03  |  3.1 KB  |  70 lines
  1. ELF_GETARHDR(3E)                                     Last changed: 10-13-98
  2.  
  3.  
  4. NNAAMMEE
  5.      eellff__ggeettaarrhhddrr - Retrieves archive member header
  6.  
  7. SSYYNNOOPPSSIISS
  8.      cccc [_f_l_a_g ...] _f_i_l_e ...  --lleellff [_l_i_b_r_a_r_y ...]
  9.  
  10.      ##iinncclluuddee <<lliibbeellff..hh>>
  11.  
  12.      EEllff__AArrhhddrr **eellff__ggeettaarrhhddrr((EEllff **eellff));;
  13.  
  14. IIMMPPLLEEMMEENNTTAATTIIOONN
  15.      IRIX systems
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      eellff__ggeettaarrhhddrr returns a pointer to an archive member header, if one is
  19.      available for the ELF descriptor, eellff.  If no archive member header
  20.      exists, an error occurred, or eellff was null, eellff__ggeettaarrhhddrr returns a
  21.      null value.  The header includes the following members:
  22.  
  23.      cchhaarr              **aarr__nnaammee;;
  24.  
  25.      ttiimmee__tt            aarr__ddaattee;;
  26.  
  27.      lloonngg              aarr__uuiidd;;
  28.  
  29.      lloonngg              aarr__ggiidd;;
  30.  
  31.      uunnssiiggnneedd lloonngg     aarr__mmooddee;;
  32.  
  33.      ooffff__tt             aarr__ssiizzee;;
  34.  
  35.      cchhaarr              **aarr__rraawwnnaammee;;
  36.  
  37.      An archive member name, available through aarr__nnaammee, is a null-
  38.      terminated string, with the aarr format control characters removed.  The
  39.      aarr__rraawwnnaammee member holds a null-terminated string that represents the
  40.      original name bytes in the file, including the terminating slash and
  41.      trailing blanks as specified in the archive format.
  42.  
  43.      In addition to regular archive members, the archive format defines
  44.      some special members.  All special member names begin with a slash
  45.      (//), distinguishing them from regular members (whose names may not
  46.      contain a slash).  The following are definitions of special member
  47.      names (aarr__nnaammee):
  48.  
  49.      //       This is the archive symbol table.  If present, it will be the
  50.              first archive member.  A program may access the archive symbol
  51.              table through eellff__ggeettaarrssyymm.  The information in the symbol
  52.              table is useful for random archive processing [see
  53.              eellff__rraanndd(3E)].
  54.  
  55.      ////      This member holds a string table for long archive member
  56.              names.  An archive member's header contains a 16-byte area for
  57.              the name, which may be exceeded in some file systems.  The
  58.              library automatically retrieves long member names from the
  59.              string table, setting aarr__nnaammee to the appropriate value.
  60.  
  61.      Under some error conditions, a member's name might not be available.
  62.      Although this causes the library to set aarr__nnaammee to a null pointer, the
  63.      aarr__rraawwnnaammee member will be set as usual.
  64.  
  65. SSEEEE AALLSSOO
  66.      eellff(3E), eellff__bbeeggiinn(3E), eellff__ggeettaarrssyymm(3E), eellff__rraanndd(3E), aarr(4)
  67.  
  68.      This man page is available only online.
  69.  
  70.